package org.example.service;

import org.example.dto.RankingDto;
import org.example.vo.RankingVo;
import org.springframework.stereotype.Service;

import java.util.List;

/**
 * @FileName RankingService
 * @Description
 * @Author coderfun
 * @selfDesc coding in fun
 * @date 2024-11-04
 **/
@Service
public interface RankingService {

    /**
     * 添加排名信息
     *
     * @param rankingDto 包含排名信息的数据传输对象，不能为空
     * @return 返回一个布尔值，表示排名信息是否成功添加true 表示成功添加，false 表示添加失败
     */
    boolean add(RankingDto rankingDto);

    /**
     * 根据 RankingDto 对象中的属性值来选择排名信息
     * @return 匹配查询条件的排名信息列表，以 List<RankingDto> 的形式返回
     */
    List<RankingVo> select();

    /**
     * 根据用户信息和比赛ID选择用户的排名
     * @param rankingDto 包含用户信息和比赛ID的DTO对象，用于查询排名
     * @return 返回用户的排名，如果找不到排名则返回null
     */
    Integer selectMyRanking(RankingDto rankingDto);
}
